<div id="log-options"></div>
<div class="header">
<p>
Next: [[cvs: log examples#log examples|log examples]], Up: [[cvs: log--Print out log information for files#log&mdash;Print out log information for files|log]] &nbsp; |[[cvs: Index#SEC_Contents|Contents]]||[[cvs: Index#Index|Index]]|</p>
</div>

----

<div id="log-options-1"></div>
==== log options ====

By default, <code>log</code> prints all information that is
available.  All other options restrict the output.

;<code>-b</code>
: Print information about the revisions on the default branch, normally the highest branch on the trunk.

;<code>-d <var>dates</var></code>
: Print information about revisions with a checkin date/time in the range given by the semicolon-separated list of dates.  The date formats accepted are those accepted by the &lsquo;<code>-D</code>&rsquo; option to many other <small>CVS</small> commands (see [[cvs: Common command options#Common command options|Common options]]). Dates can be combined into ranges as follows:

:;<code><var>d1</var>&lt;<var>d2</var></code>
:;<code><var>d2</var>&gt;<var>d1</var></code>
:: Select the revisions that were deposited between <var>d1</var> and <var>d2</var>.

:;<code>&lt;<var>d</var></code>
:;<code><var>d</var>&gt;</code>
:: Select all revisions dated <var>d</var> or earlier.

:;<code><var>d</var>&lt;</code>
:;<code>&gt;<var>d</var></code>
:: Select all revisions dated <var>d</var> or later.

:;<code><var>d</var></code>
:: Select the single, latest revision dated <var>d</var> or earlier.

: The &lsquo;<code>&gt;</code>&rsquo; or &lsquo;<code>&lt;</code>&rsquo; characters may be followed by &lsquo;<code>=</code>&rsquo; to indicate an inclusive range rather than an exclusive one.

: Note that the separator is a semicolon (;).

;<code>-h</code>
: Print only the name of the <small>RCS</small> file, name of the file in the working directory, head, default branch, access list, locks, symbolic names, and suffix.

;<code>-l</code>
: Local; run only in current working directory.  (Default is to run recursively).

;<code>-N</code>
: Do not print the list of tags for this file.  This option can be very useful when your site uses a lot of tags, so rather than &quot;more&quot;&rsquo;ing over 3 pages of tag information, the log information is presented without tags at all.

;<code>-R</code>
: Print only the name of the <small>RCS</small> file.

;<code>-r<var>revisions</var></code>
: Print information about revisions given in the comma-separated list <var>revisions</var> of revisions and ranges.  The following table explains the available range formats:

:;<code><var>rev1</var>:<var>rev2</var></code>
:: Revisions <var>rev1</var> to <var>rev2</var> (which must be on the same branch).

:;<code><var>rev1</var>::<var>rev2</var></code>
:: The same, but excluding <var>rev1</var>.

:;<code>:<var>rev</var></code>
:;<code>::<var>rev</var></code>
:: Revisions from the beginning of the branch up to and including <var>rev</var>.

:;<code><var>rev</var>:</code>
:: Revisions starting with <var>rev</var> to the end of the branch containing <var>rev</var>.

:;<code><var>rev</var>::</code>
:: Revisions starting just after <var>rev</var> to the end of the branch containing <var>rev</var>.

:;<code><var>branch</var></code>
:: An argument that is a branch means all revisions on that branch.

:;<code><var>branch1</var>:<var>branch2</var></code>
:;<code><var>branch1</var>::<var>branch2</var></code>
:: A range of branches means all revisions on the branches in that range.

:;<code><var>branch</var>.</code>
:: The latest revision in <var>branch</var>.

: A bare &lsquo;<code>-r</code>&rsquo; with no revisions means the latest revision on the default branch, normally the trunk. There can be no space between the &lsquo;<code>-r</code>&rsquo; option and its argument.

;<code>-S</code>
: Suppress the header if no revisions are selected.

;<code>-s <var>states</var></code>
: Print information about revisions whose state attributes match one of the states given in the comma-separated list <var>states</var>.

;<code>-t</code>
: Print the same as &lsquo;<code>-h</code>&rsquo;, plus the descriptive text.

;<code>-w<var>logins</var></code>
: Print information about revisions checked in by users with login names appearing in the comma-separated list <var>logins</var>.  If <var>logins</var> is omitted, the user&rsquo;s login is assumed.  There can be no space between the &lsquo;<code>-w</code>&rsquo; option and its argument.

<code>log</code> prints the intersection of the revisions
selected with the options &lsquo;<code>-d</code>&rsquo;, &lsquo;<code>-s</code>&rsquo;, and
&lsquo;<code>-w</code>&rsquo;, intersected with the union of the revisions
selected by &lsquo;<code>-b</code>&rsquo; and &lsquo;<code>-r</code>&rsquo;.


----

<div class="header">
<p>
Next: [[cvs: log examples#log examples|log examples]], Up: [[cvs: log--Print out log information for files#log&mdash;Print out log information for files|log]] &nbsp; |[[cvs: Index#SEC_Contents|Contents]]||[[cvs: Index#Index|Index]]|</p>
</div>
This document was generated on <i>a sunny day</i> using [http://www.nongnu.org/texi2html/ <i>texi2html</i>].
